package com.atguigu.tingshu.album;

import com.atguigu.tingshu.album.impl.AlbumDegradeFeignClient;
import com.atguigu.tingshu.common.result.Result;
import com.atguigu.tingshu.model.album.*;
import com.atguigu.tingshu.vo.album.AlbumStatVo;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

import java.util.List;

/**
 * <p>
 * 专辑模块远程调用Feign接口:简化服务调用，自动拼接请求路径，请求方式，入参，封装出参
 * </p>
 *
 * @author atguigu
 *
 * 前提：所有服务都需要注册到Nacos注册中心，在注册中心保存每个服务对应服务实例列表
 *      例如：service-album  包含2个实例  192.168.40.58:8501,192.168.40.58:8401
 * 调用方（搜索服务）调用过程：第一次远程调用耗时较长
 *   1. 根据FeignClient注解服务名称，从Nacos注册中心获取service-album服务实例列表
 *   http://service-album/api/album/albumInfo/getAlbumInfo/{id}
 *   2. 基于底层负载均衡器LoadBalancer组件（第一次使用才会初始化），默认轮询算法，从服务实例列表中选择一个实例
 *   第一次请求：http://192.168.40.58:8501/api/album/albumInfo/getAlbumInfo/{id}
 *   第二次请求：http://192.168.40.58:8401/api/album/albumInfo/getAlbumInfo/{id}
 */
@FeignClient(value = "service-album", path = "/api/album" ,fallback = AlbumDegradeFeignClient.class)
public interface AlbumFeignClient {

    /**
     * 查询专辑信息，包含专辑标签列表
     *
     * @param id
     * @return
     */
    @GetMapping("/albumInfo/getAlbumInfo/{id}")
    public Result<AlbumInfo> getAlbumInfo(@PathVariable Long id);


    /**
     * 后续改为Redis缓存
     * 根据三级分类ID查询分类视图
     * @param category3Id
     * @return
     */
    @GetMapping("/category/getCategoryView/{category3Id}")
    public Result<BaseCategoryView> getCategoryView(@PathVariable Long category3Id);


    /**
     * 后续改为Redis缓存
     * 获取1级分类ID查询置顶7个三级分类列表
     * @param category1Id
     * @return
     */
    @GetMapping("/category/findTopBaseCategory3/{category1Id}")
    public Result<List<BaseCategory3>> findTopBaseCategory3(@PathVariable Long category1Id);

    /**
     * 查询专辑统计信息
     * @param albumId 专辑ID
     * @return
     */
    @GetMapping("/albumInfo/getAlbumStatVo/{albumId}")
    public Result<AlbumStatVo> getAlbumStatVo(@PathVariable Long albumId);

    /**
     * 查询所有一级分类集合
     *
     * @return
     */
    @GetMapping("/category/findAllCategory1")
    public Result<List<BaseCategory1>> findAllCategory1();



    /**
     * 基于选择购买声音ID作为起始获取指定数量未购买声音列表
     *
     * @param trackId
     * @param trackCount
     * @return
     */
    @GetMapping("/trackInfo/findPaidTrackInfoList/{trackId}/{trackCount}")
    public Result<List<TrackInfo>> findWaitBuyTrackList(@PathVariable Long trackId, @PathVariable Integer trackCount);


    @GetMapping("/trackInfo/getTrackInfo/{id}")
    public Result<TrackInfo> getTrackInfo(@PathVariable Long id);
}
